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METHODS FOR CHANGING KERNEL TUNING PARAMETERS 

FIELD OF THE INVENTION 
[0001] The present invention relates to methods and apparatus for 
operating a computer and more specifically to methods and apparatus for 
managing the manner in which an operating system and its modules are 
tuned to improve computing performance. 

BACKGROUND OF THE INVENTION 

[0002] Tunable parameters" (sometimes also referred to as 
"tunable variables" or simply "tunables") are variables that affect the operation 
of an operating system kernel by setting table sizes and system thresholds, 
among other things. Tunable parameters also control characteristics of 
processes, files, and system activity, and thus provide a way in which 
operating system kernels can be optimized for particular computers or 
installation or usage circumstances. For example, a "maxusers" tunable 
parameter may be provided to adjust the size of tables, arrays, buffers, etc. to 
optimize system performance for the expected number of users on a system. 
System administrators will be familiar with the tunable parameters that 
optimize their operating system kernels to various computer systems, 
installation, and/or usage circumstances, in some instances, kernels are 
recompiled and relinked for tuning, and to add drivers and subsystems. 

[0003] Many tunable parameters are related to each other by 
constraints. For example, the number of files each user is allowed to have 
opened must necessarily be less than the number of files allowed opened on 
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the whole system. Administrators who wish to change related values must be 
careful to change the in the proper order to avoid violating such constraints. 
This need for extra care makes tuning the system more difficult. 



SUMMARY OF THE INVENTION 
[0004] In one configuration, there is therefore provided a method for 
operating a computing apparatus that includes specifying proposed changes 
to a plurality of tunable parameters of tunable kernel modules determining 
whether application of the changes would violate a set of constraints; and 
effectuating either none or all of the changes depending upon whether the 
changes were determined to violate any or none of the constraints, 
respectively. 

[0005} Another configuration provides a computing apparatus 
having a central processing unit and a memory, wherein the computing 
apparatus is configured to specify proposed changes to a plurality of tunable 
parameters of tunable kernel modules; determine whether application of the 
changes would violate a set of constraints; and effectuate either none or all of 
the changes depending upon whether the changes were determined to violate 
any or none of the constraints, respectively. 

[0006] Yet another configuration provides a medium or media 
having machine-readable instructions recorded thereon configured to instruct 
a computing apparatus having a central processing unit and a memory to 
specify proposed changes to a plurality of tunable parameters of tunable 
kernel modules; determine whether application of the changes would violate a 
set of constraints; and effectuate either none or all of the changes depending 
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upon whether the changes were determined to violate any or none of the 
constraints, respectively- 

[0007] Further areas of applicability of the present invention will 
become apparent from the detailed description provided hereinafter, it should 
be understood that the detailed description and specific examples, while 
indicating the preferred embodiment of the invention, are intended for 
purposes of illustration only and are not intended to limit the scope of the 
invention, 

BRIEF DESCRIPTION OF THE DRAWINGS 
^ {0008] The present invention will become more fully understood 

*K from the detailed description and the accompanying drawings, wherein: 

3 [0009] Figure 1 is a simplified flow chart of one configuration of a 

q registration process of the present invention. 

IL.-,il, 

h. | [0010] Figure 2 is a flow chart showing a process tor loading a 

Tz dynamically loadable kernel module (DLKM) and registering and accessing its 

tunable parameters. 

10011] Figure 3 is a flow chart providing additional details of one 

configuration of the tunable parameter access procedure referred to in Figure 

1. 

[0012] Figure 4 is a flow chart providing additional details of another 
configuration of the tunable parameter access procedure referred to in Figure 
1. 
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[0013] Figure 5 is a block diagram of one configuration of a 
computing apparatus useful for performing the processes Illustrated in Figures 
1-4. 

[001 4J The flow charts included herein do not necessarily represent 
a single thread of execution in a single computer process, but rattier, in some 
instances, may represent a sequence of coordinated steps, events, or 
processes occurring in a plurality of threads. In addition, the flow charts 
herein should not be Interpreted as implying that no other events, steps or 
processes can occur between those explicitly represented in the drawings. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 
[0015] The following description of the preferred embodiment(s) is 
merely exemplary in nature and is in no way intended to limit the invention, its 
application, or uses. Also, as used herein, "at least one of A or B" 
encompasses configurations comprising either A or B, and configurations 
comprising both A and B. In addition, a "memory" of a computing apparatus 
may comprise any appropriate type of primary or secondary storage, unless 
the type of memory is further specified. Examples of primary storage include 
cache memory, random access memory, and read only memory. Examples 
of secondary storage include hard disks, floppy diskettes, CD-ROMs and CD- 
RW. One skilled in the art would take into account whether a memory must 
be writable or need only be readable to determine whether a particular type of 
primary or second storage would be appropriate for a given use. 

[G016J In one embodiment and referring to Figure 1, an operating 
system for controlling a computing apparatus {for example, a computer having 
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a central processing system and a memory such as RAM) includes a kernel 
and one or more kernel modules, A ''kernel module," as used herein, refers to 
a dynamically loadable kernel module, a subsystem within a kernel module, a 
driver, or another grouping of code that is run as a part of, or subsidiary to, the 
operating system kernel. One or more of the kernel modules have 
corresponding sets of one or more associated tunable parameters. 

[0017] The computing apparatus is configured to initialize itself by 
booting 10 the operating system from a storage device such as a hard drive. 
The operating system includes a "tunable parameter registration function/ 
which is a function that can be called by a kernel module to "register" a 
tunable, i.e., cause kernel-accessible information about the tunable to be read 
from a portion of memory maintained by the kernel as a "kernel registry." 
(The kernel registry can be in RAM or disk storage, or eJsewhere r depending 
upon the operating system and the computing apparatus on which it is 
running,) In one configuration, the tunable parameter registration function is 
made available for use by kernel modules before any kernel module requires 
access to values of tunable parameters. The operating system also includes 
a plurality of kernel modules that are installed 12 during the boot process or 
as needed. At least some of kernel modules 12 are "tunable kernel modules" 
in that they have at least one tunable parameter and at least one handler 
function. For present purposes, no further consideration is given to kernel 
modules without at least one tunable parameter and handler function. 
However, the presence of kernel modules other than tunable kernel modules 
is not intended to remove any such configuration from the scope of the 
present invention. 
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[0018] Handler functions are configured to obtain (i.e., read) or 
change a value of a tunable parameter after the parameter is registered. In 
one configuration, some handier functions may be configured both to read 
and change a value of a tunable parameter, depending upon how it is 
invoked. Certain handler functions are configured in one configuration to be 
invoked with one or more arguments that specify a plurality of changes 
corresponding to a selected subset of registered tunable parameters. Other 
handler functions are configured to be invoked with an additional argument 
that specifies when a change requested by the handler function is to be 
effectuated. 

[0019] To install" a kernel module, information about the kernel 
module and its tunable parameters is read from a storage medium such as a 
CD-ROM or a hard drive, and the operating system kernel notes the existence 
of the module. Information about tunable parameters is written to the kernel 
registry by the operating system kernel, and the tunable parameters are 
marked as being "available." Information about the tunable parameter is, in 
one configuration, a data structure containing static information about the 
tunable parameter, such as name, one-line description, default value, etc. 
The tunable is marked as being available, in one configuration, by setting a bit 
that serves as an availability flag for the tunable parameter in the registry 
memory, 

[0020] The first time a kernel module is loaded 14 into memory (as 
distinguished from being "installed"), it uses the registration function to 
register all of its tunable parameters. For example, core kernel modules 
register their tunable parameters at boot time, dynamically loadable tunabte 
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parameter modules register their tunable parameters at load time, and drivers 
register their tunable parameters at instance creation time. In registering 
tunable parameters, the kernel module passes 16 the name (or some other 
indication of identity) of its tunable parameter or parameters to the tunable 
registration function, which reads information about the tunable parameter 
from the registration memory. This information, which includes the value of 
the tunable parameter, is read 18 by the kernel module using the tunable 
parameter registration function. In addition, the kernel stores an indication 
that the tunable parameters) are available for at least one of read or write 
access. In one configuration, either the operating system kernel or the kernel 
module associated with a tunable parameter also provides a default value, an 
allowed range, and one or more dynamic and/or automatic tuning procedures 
for a tunable parameter upon registration, 

[0021] In at least one configuration, some tunable parameters 20 
are marked "private" in the kernel registry. The operating system kernel 
prevents unprivileged access to the private tunable parameters, (What 
constitutes "privilege" is defined by the operating system. For example, a 
privilege bit may be set for a user or an owner of a process.) If there are more 
drivers or kernel modules to load 22, more kernel modules are loaded 14, and 
the process described above repeats for each of them. 

[0022] In one configuration, registered tunables are organized 24 
into a plurality of namespaces, so that tunables from different kernel modules 
that share the same name are distinguishable. Handler functions used to 
access the tunable parameters are registered 26 to the tunables. Thus, at a 
later time, when a kernel module requires access to a tunable parameter 
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{e.g., to read a value that may have been changed, or to write a new value for 
the tunable, if it is permitted to do so), that kernel module can access 28 its 
tunable parameter or parameters via the handler function. 

[0023] Each kernel module having one or more tunable parameters 
provides one or more handier functions for its tunabfe parameters. A "handler 
function** is a function that performs a call to the operating system kernel to 
access (i.e., read or write) one or more tunable parameters. Thus, in one 
configuration, tunable parameters are accessed 28 via handler functions 
rather than by reading system tables. In one configuration having more than 
one kernel module, a first kernel module can load itself, register its one or 
more tunable parameters, and access its one or more tunable parameters, a 
second kernel module can do the same, as can others. 

[0024] Although the examples herein generally describe only kernel 
modules as accessing tunable parameters utilizing handler functions, the 
handler functions may be made available to other programs that access 
tunable parameters. For example, a user with administrator privileges may 
access tunable functions through an administration program. In one 
configuration, the operating system kernel itself registers its own tunabies and 
accesses them through handler function calls. 

[0025] fn the configuration represented in Figure 1, tunable 
parameter values are not compiled into the operating system kernel, but are 
instead stored in a kernel registry that is maintained by the operating system 
kernel. In one configuration, all information about tunable parameters is 
stored in the kernel registry, including any supplied default values, allowed 
ranges, descriptions, and help text. This help text is available for software 
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tools to use for on-line display when a user or a system administrator displays 
or alters the values of a tunable parameter. In another configuration, full 
online help text is omitted to reduce memory required for storage. 

[0026] Although kernel modules having tunable parameters may atl 
be loaded at boot time, it should be understood that there is no requirement 
for doing so. Moreover, kernel modules can be dynamically loadable, i.e., 
loadable and unloadable, as needed. Thus, in one configuration, once a 
dynamically loadable kernel module (DLKM) has been installed, it can be 
il loaded 30 for the first time, as represented in Figure 2. The DLKM registers 

;:■ if! 

Cj 32 its tunable parameters by passing the name of each tunable parameters to 

p the tunable parameter registration function, which reads 34 the value of each 

tunable parameter from the registry memory. The DLKM uses the value of 
the tunable parameter read in this way. Tunable parameter registration 
J-f entries for the DLKM are retained in memory even if the DLKM is 

M subsequently removed 36 from memory. The tunable parameters remain in 

M the kernel registry and information about the tunable parameters are 

preserved indefinitely in case the DLKM from which the tunable parameters 
were registered is ever reloaded 38. In this case, the tunabfe parameters are 
not registered a second time. Further access 40 to the tunable parameters is 
via a DKLM handler function using information about the tunable parameters 
of the DKLM retained in the registry memory from the first time the DKLM was 
loaded. 

[0027] in one configuration and referring to Figure 3, a handler 
function accesses a tunable parameter and determines, from information 
made available from operating system kernel function calls, whether a specific 
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value change in a tunable parameter is permissible. More particularly, to 
access a tunable parameter (28 in Figure 1) a kernel module calls 42 a 
handler function with a proposed new value for a tunable parameter. Also in 
one configuration, the kernel module provides the handler function with 
requested time at which the operating system kernel is to effect the change in 
the value. The handler function determines 44 from information made 
available from the operating system kernel, whether the proposed value is 
within a predetermined valid range or is a member of a set of predetermined 
values. For example, the handler function may make this comparison itself 
within the kernel module, or the operating system may return a flag based 
upon a comparison of the proposed value with limits for the tunable parameter 
stored in the registry. If the proposed value is not within the valid range, no 
change is made to the tunable value in the registry. In addition, an error 
message {which, in one configuration, is obtained from the help text 
associated with the tunable parameter in the registry) is displayed 46, if it is 
possible to do so, or a flag or other argument is returned to the calling 
program to indicate the error. For example, an administration program may 
display an error message on a console if an administrator attempts to use the 
program to set an invalid tunable value. On the other hand, if the proposed 
change is validated, the value of the tunable parameter is changed 48 by the 
operating system kernel If a time for the change to occur was specified, the 
change is stored in a buffer until the proper time. For example, a selection of 
times is provided in one configuration, including an immediate change, a 
delayed change, and a change after a system reboot. 
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[0028] In one configuration, there are three types of tunable 
parameters, namely, static, dynamic and automatic, depending upon when 
they can be changed. Static tunable parameters are tunable parameters that 
can be changed oniy by rebooting. Kernel modules or drivers with static 
tunable parameters register these tunable parameters at boot time. 
Thereafter, the registering kernel module can query the values of the static 
tunable parameters and save the values in variables local to the module. The 
value of the tunable parameter will never be changed while the kernel module 
or driver is running, so the registered tunable parameter need not be queried 
again and the locally stored copy of the tunable parameter value can be 
referred to indefinitely. A handler function is provided for static tunable 
parameters, but the handler function cannot change the value of static tunable 
parameters without a reboot. Handler functions for static tunable parameters 
can, however, determine whether a new value is valid (e.g., within a valid 
range) and t if so, write the value to storage so that the change is effectuated 
after a reboot occurs. 

[0029] Dynamic tunable parameters can be changed at will. In 
addition to handler functions that query the value of dynamic tunable 
parameters, modules with dynamic tunable parameters contain handler 
functions that are called whenever a request is made to change the value of 
registered dynamic tunable parameters. 

10030] Automatic tunable parameters can be changed at will and 
have handler functions similar to those of dynamic tunable parameters. 
However, in addition to (or in place of) any changes to a dynamic tunable 
parameter that a kernel module may make, the operating system kernel itself 
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is able to change automatic tunable parameters in response to changing 
system conditions. Handler functions are called to query the values of 
automatic tunable parameters. 

[0031] Other tunable parameter variables that have automatic 
tuning procedures that need not or should not be overridden by an 
administrator need not be considered as tunable parameters, and in one 
configuration, are not treated as such. 

[0032] Thus, in one configuration and referring to Figure 4, a 
handler function is provided that can be called with set of proposed values for 
a specified subset of corresponding tunable parameters. The handler function 
is invoked 50 with the proposed new values. A determination is made 52 as 
to whether all of the proposed new values are within predetermined valid 
ranges of the corresponding tunable parameters. (The predetermined valid 
range may, in general, be different for each tunable parameter in the set In 
one configuration, one or more additional checks are performed on the 
proposed new value or values. For example, a check is performed to 
determine whether the computer has sufficient physical resources such as 
memory to accommodate a value change.) If not all of the values are within 
their respective valid ranges (or any additional check fails), an error message 
is provided 52 if possible, and none of the proposed changes is made to the 
tunable parameters. Also in one configuration, it is determined 54 whether 
any of the specified set of tunable parameters is a static tunabte parameter. If 
so, the entire set of changes is stored in a buffer other than the registry and 
the changes are made effective 56 (i.e., written from the buffer to the registry 
so that the are returned to handler functions attempting to read one or more of 
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the tunable parameters) only after the next boot of the operating system. 
Otherwise, al! of the changes to the values of the tunable parameters are 
made effective at the same time, or in a predefined order 58. (By "predefined 
order," it is meant that changes to the subset of tunable parameters are 
effectuated in a specific order, for example, an order required by constraints 
imposed by the operating system kernel.) In another configuration not shown 
in Figure 4, invocation 50 of the handler function includes providing one or 
more arguments to the handler function that specify an order in which the 
proposed new values are to take effect. Whether or not a specified order is 
permissible is verified in one configuration before allowing the change to take 
effect, in yet another configuration not shown in Figure 4, invocation 50 of the 
handler function includes providing one or more arguments to the handler 
function that specify a time at which the proposed new values are to take 
effect. For example, an argument may be provided that specifies that the 
entire set of changes is to be stored in a buffer other than the registry and the 
change made effective 56 only after the next boot of the operating system, 
even if none of the tunable parameters to be changed is a static tunable 
parameter. 

[0033] Because tunable parameters may be functions of one 
another, one tunable may be initialized to a value that depends upon the 
value of one or more other tunable parameters. In such a state, a desfred 
change to a single tunable parameter may result in changes to the values of 
many more tunable parameters al the same time. In one configuration, these 
dependencies are incorporated into the handler functions, which take care of 
processing all of the changes to tunable parameters so that all of the changes 
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are effectuated at the same time. The configuration described above 
processes such transactions by ensuring that either none or all of the changes 
of a transaction proposing multiple changes to more than one tunable are 
effectuated. There is no middle ground for such transactions. In addition, no 
duplicate changes are allowed within a transaction, I.e., no more than one 
change to the same attribute or property of a tunable parameter is allowed per 
transaction. However, no restriction is imposed on the order in which the 
tunable parameters are specified in a transaction. If any of the tunable 
parameters in a transaction require a reboot to take effect, then the entire 
transaction requires a reboot for the changes to be effectuated. 

[0034] By separating changes to the tunable parameters into three 
phases, namely validate, prepare, and commit, ft is possible to ensure that all 
of the changes are valid when applied together, all of the changes are 
prepared to be applied together, and all of the changes are actually applied 
together. 

[0035] To take maximum advantage of tunable parameters, the 
operating system kernel registers all tunable parameters and queries their 
values at boot time. Tunable parameter values are not compiled into the 
kernel In configurations in which a previously-existing kernel is being 
updated, default values and range limits of the tunable parameters are 
reviewed and, if necessary, these default values and ranges are updated to 
appropriate values. In addition, tunable parameters that are no longer needed 
are removed. 

[0036] Tunable parameters that are not intended to be visible to 
users of the kernel {as opposed to kernel developers) are marked "private" in 
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the tunable parameter registry so that they cannot be viewed or changed by 
unauthorized individuals or programs. Existing applications that query the 
values of tunable parameters but do not set them can continue to do so* but 
should, and in one configuration, must be changed so that handler functions 
are used. 

[0037J In some cases, one or more tunable parameters may change 
while an application is running, so applications should be configured to take 
into account this possibility, in one configuration, the operating system kernel 
y prevents applications from editing tunable parameters in system files. 

Therefore, to change tunable parameters in this configuration, an application 
% 4 must use a tunable parameter handler function. In addition, applications that 

45 provide information about tunable parameters should use the information 

s" returned by a handler function that queries the kernel rather than by hard- 

p coding such information, as not only the values of tunable parameters, but 

§ also the list of tunable parameters may change from one moment to the next, 

ih* Therefore, in one configuration, an event notification procedure is provided to 

notify applications of tunable parameter value changes. In one configuration, 
ail applications and kernel application program interfaces (APIs) dealing with 
tunable parameters utilize the same semantics, including the same names, 
allowed values, help text, visibility and modification characteristics. 

[0038] Existing functions used to access tunable parameters should 
be modified to obtain information from the kernel rather than by accessing 
master files and system files directly. The kernel registry service is made 
available for both read and write at an early point as the kernel is booting, 
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before the values of any tunable parameters are needed by modules or 
drivers. 

[0039] An example of a computing apparatus 200 configured to 
operate in accordance with the above description is represented in Figure 5. 
Cabinet 202 houses a central processing unit (CPU) and associated random 
access memory (neither of which are shown separately in Figure 5, but which 
are well-known in the art), in addition to random access memory, the CPU 
also communicates with other memory storage devices, for example, floppy 
disk drive 204, hard disk drive 206, and CD-ROM drive 208. In one 
configuration, the operating system is stored on hand disk drive 206 (or more 
generally, on one or more memory storage devices or media) and booted by 
the CPU when power is applied to computer system 200, when a switch is 
thrown on cabinet 202, when a command is issued from keyboard 210, or at 
other times in response to software or firmware instructions. To control the 
multiple processes and process threads, multiple thread schedulers and 
kennel modules are used. In one configuration, machine readable instructions 
configured to control computing apparatus 200 to execute the steps and 
procedures described herein are recorded on one or more media 212, for 
example, one or more floppy diskettes or CD-ROMS. 

[0040] It will thus be seen that configurations of the present 
invention provide consistent, modular access to tunable parameters that is 
easily understood and implemented by system administrators as well as 
system and application programmers. Moreover, in configurations of the 
present invention providing value validation of proposed changes in tunable 
parameter values, an opportunity for error recovery is provided, and changes 
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to groups of tunable parameters can be coordinated so that error conditions 
are avoided. More particularly, in one configuration, the present invention 
allows administrators to specify all tunable parameter changes at once without 
having to figure out order in which the changes must be applied to avoid 
violating constraints. Also in one configuration, a three-phase commit 
mechanism ensures that none of the changes will be applied unless all of 
them can be applied successfully. 

[0041] The description of the invention is merely exemplary in 
nature and, thus, variations that do not depart from the gist of the invention 
are intended to be within the scope of the invention. Such variations are not 
to be regarded as a departure from the spirit and scope of the invention. Also, 
otherwise explicitly qualified {such as by reciting "only one" element or "no 
more than two" elements), claims that recite "one," "at least one," "one of," 
"a," or "an" element, or any specific number of elements are not intended to 
exclude embodiments having a greater number of elements than those 
recited. 
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